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The MHJA.3 Linking Loader is a PUE-6 program to load rclocatable- 
fomat output from, the KIDA5 assembler, with facilities to handle 
symbolic CTO 5 5 -re£erences between independently assembled programs . . 
Although it is arranged primarily to load from DECtapCj the loader is able 
to load paper-tap-e relocatable pro-grams. 

To use the loader, load it off the MACDMP STSTEM tape as the file 
5TIMK. (A file STlttK NhW may exist, repairing old bogs or Introducing 
new features.) Then the leader expects commands to be typed in on the 
on-line Teletype; two successive ALT MODE characters terminate the string 
of coamands. The commands in a string are not performed until the String 
is thug terminated. While a command string has not been terminated„ 
itUBOUT will erase the last typed-itt character [and type it out again as & 
reminder). A command String may contain any number Of commands, and the 
effect is the same whether the commands are together in one string or are 
in successively typed-in strings each delimited by two ALT MQDEg, 

The loader maintains two tables whose contents may change as programs 
are loaded: [a} the Loader Tabic, which contains definitions of global 
symbols and! unresolved virtual usages; (b) the local symbol table., con¬ 
taining all program names, and the local symbols for each program for 
wlilch their loading was requested. 

in the following command descriptions, n is an octal number, or one of 
the command characters said to have a value, (l) is ALT MODE, which echoes 
out as 3 , ^ represents SPACE. 


2 


Command Form 

FfeartinE 

F 

Set te mad from the paper tape reader, (Tape 
must tie in the reader* and the reader must 
be on when this command is performed,} 

nMn&mel^isameS 

Set to read from beginning of file namel name 2 
on DECtape unit n, (If n is omitted, the 
last DECtape mentioned is assumed,) 

N 

Load selected input file without local symbols. 

L 

Load selected input file* saving local symbol 

definitions for DDT. (ft and L set the Current 
Starting Address to that specified in the 
program loaded if that is not 0,} 

T 

Copy all defined global symbols in the Loader 

Table into the local symbol table (for DDT) ; 
then delete same from the Loader Table. 

Li 

Read in the relocatable version of BUT from 

DECtape unit I* tell it of all symbols in 
the local symbol table; wipe out the loader 
and transfer Control to DDT, 

nF 

List files of DECtape unit n. (As in the M. com¬ 
mand, the argument ^ may be omitted,) 

C 

Transfer control to the Current Starting Address, 

TlC 

Set the Current Starting Address to j}_ and transfer 
control thereto. 

n- 

Print the value of as an octal integer. 

X 

Has the value of the Current Starting Address. 

E 

Has the value of the lowest address currently used 
by the loader. 

K 

Delete all lecal and global symbols fro* the local 
symbol table and the Loader Table, 

2 

Zero cere except registers 2$ through J7 and the 
leader (from & up). 

”[ 

Print contents of location n_. 
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£ 

Has the current value of program relocation, 

n.R 

Set program relocation to n + 

nC 

Set common relocation to n, 

S 

Print storage map’ Each program in core has one 
line in the map. At the left is the program 
name, and at the right ih octal is a word 
whose right half is the first location used by 
the progran and whose left half is the last 
location used by the program. 

7 

Print storage map and aissing list (short form]. 

Each program loaded appears as follows! One 
line with the program name at the left and 
the first address used by the program at the 
right! any numbeT of lines indented one space, 
each listing an undefined symbol used in that 
program, with the address of its first use 
therein. Symbols arc global unless preceded 
by * f meaning local. 

n? 

Print storage map and missing list (long form). 

(litre the value of n is immaterial, hut an 
argument must be given.) Like ? with the fol¬ 
lowing changes! (a) following the program 
name is a 36-bit word in octal with first and 
last addresses as for the £ command; (b) the 
address is given of each reference to each 
undefined symbol. 

n <sym> 

Define symbol syn with the value tu The symbol 
will be global unless a * is typed somewhere 
between ^ and >. 

Error Message 

We aning 

SCE adr 

Storage capacity exceeded■ The program being 
loaded Collided with the loader at adr. 

UGA adr sym 

Undefined global assignment. The global symbol 

sym was undefined when needed Tiy the loader to 
perform a parameter assignment or location 
assignment. The current loading address is adr. 

MDG adr sym 

Multiply defined global. .A defined global appeared 

to the left of a i when adr* the current location^ 
did not equal the value of the global. It was 
not redefined. 
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□leeksum error. 

Pile not found on HECtipe specified. 

Too much symbols: occurs when loading PUT, and 
that DPT + Symbols * program exceeds storage 
available by num resistors. 

Illegal memory reference: an error by the loader, 

A tape labelled LIBRARY is available, containing various useful sub¬ 
routines in the file LlBRAR l. Up-to-date details are posted In the FDP-6 
room. Each program in the library file was assembled with the .LIBRA 
pseudoinstruction, and so will be loaded only if in the Loader Table is a 
request for a global symbol defined in that program. ThETefore the library 
file should not be loaded until all programs have boon Loaded which make 
reference to the library subroutines. 


CKS 

FNF 

TMS num 

ILK 


Command String Exespies 

[alj To toad the program AFLHA RALPHA from OECtape unit 3, the program 
SUBR 1 from unit 2, and the program ER from unit 2, then to get a 
Storage map and missing list: 

3MALPH\/A [iPHA Q L 2MSU BR^l 0 LHSUBR J. 0 L7 00 

In this example, L was used for each program to load its local 
symbols, the N command could have been used in each case instead 
not to Load Local symbols, 

(a2) Then to go to DPT; 

TD00 

(b) To load the program in the paper-tape reader and transfer to its 
starting address: 

PNG ©(f) 


The L com/nand was not used here because DDT was not requested. 
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(c) to load PROG REL from DECtspe unit I and the -requested library 
routines from unit 4; 

IMPftOGiJtEL<8 L4ML1BRAR^1 ©NgJJJ) 


